home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / arc / av605.zip / AV.DOC next >
Text File  |  1996-05-28  |  9KB  |  199 lines
  1. AV.DOC                               1                         Revised: 05/28/96
  2.  
  3. The AV.EXE program shows a directory of one or more  archive  files  (ZIP,  ZOO,
  4. etc), including some self-extracting files.  Features of this program:
  5.  
  6.   * The directory information is presented in full-screen mode and you can
  7.     use PgUp and PgDn to scroll about the screens.
  8.   * Allows you to sort the display of the members in a number of ways.
  9.   * Allows you to reset the file date of the archive to match the date of
  10.     the most recent member of the archive.
  11.   * Provides the ability to filter out what members are displayed.
  12.   * Scroll through up to 500 archives.
  13.  
  14.  
  15. A typical display might look (in part) like the following:
  16.  
  17. AV602.ZIP         Date      Time  OrigSize Method    NowSize  %reduce
  18. ------------  --------  -------- --------- -------- --------  -------[PgUp]
  19. AV.DOC        96/02/04  18:32:36      8585 Deflated     3395    61   [PgDn]
  20. AV.EXE        96/02/11  11:09:56    166744 Deflated   107879    36   [Home]
  21. BRUCE602.DOC  96/02/05  20:31:56     32493 Deflated    12566    62   [End]
  22. BRUCEINI.DOC  96/01/20  16:09:18      7649 Deflated     2891    63   [Up]
  23. FILE_ID.DIZ   96/01/28  12:26:36       214 Deflated      191    11   [Down]
  24.                                                                      [Sort]
  25.                                                                        [Name]
  26.                                                                        [Ext]
  27.                                                                        [Date]
  28.                                                                        [Size]
  29.                                                                        [CurSize]
  30.                                                                        [Ratio]
  31.                                                                        [Path]
  32.                                                                        [Orig]
  33.                                                                        [-Flip]
  34.                                                                      [Filter]
  35.                                                                      [C-PgDn]
  36.                                                                      [C-PgUp]
  37.                                                                      [Quit]
  38.  
  39. ============  ========  ======== ========= ======== ========  =======[Help]
  40.  *5           96/02/11  11:09:56    215685            126922    42%  [Date]
  41. AV602.ZIP     96/02/11  11:10:16    127418                                  /ON
  42.  
  43.  
  44.  
  45. AV.DOC                               2                         Revised: 05/28/96
  46.  
  47. When viewing a screen's worth of information, you can typically choose  among  a
  48. number of options including the following:
  49.  
  50.         PgUp    view the previous screen's worth
  51.         PgDn    view the next screen's worth
  52.         Home    top line
  53.         End     bottom line
  54.         Up      move the screen up one line
  55.         Down    move the screen down one line
  56.         Sort    change the sort order for this and subsequent files;
  57.                 you're prompted for "BY?" and you should enter either
  58.                 "-x" or "x" or press Esc to get out of this: the archive
  59.                 is reread after you ask to re-sort it; x is one of:
  60.                         N = file name
  61.                         E = file extension
  62.                         S = file size of the original (non-compressed) file
  63.                         C = current (compressed) size of the file
  64.                         D = file date and time
  65.                         R = compression ratio
  66.                         P = path and file name order
  67.                         O = original order (no sorting)
  68.                 the "-" says to reverse the sort order (e.g. biggest files
  69.                 first instead of last)
  70.         Filter  prompts you for a string; only member names that match that
  71.                 string are allowed through (does not accept wildcards; just say
  72.                 something like "COM" if you want all COM files)
  73.         Ctrl-PgDn go to the next archive file (if any)
  74.         Ctrl-PgUp go to the previous archive file (if any)
  75.         Quit    return to DOS (Ctrl-C also works) (with confirmation)
  76.         Date    update the archive date
  77.         Del     delete the archive (with confirmation)
  78.         F1      help information
  79.  
  80. These options are presented on the right side of the screen and can be  selected
  81. with the mouse cursor if one is available.
  82.  
  83.  
  84. Specifying parameters:
  85.  
  86. Parameters for this program can be set in the following ways.  The last  setting
  87. encountered always wins:
  88.   - Read from an *.INI file (see BRUCEINI.DOC file),
  89.   - Through the use of an environmental variable (SET AV=whatever), or
  90.   - From the command line (see "Syntax" below)
  91.  
  92.  
  93.  
  94. AV.DOC                               3                         Revised: 05/28/96
  95.  
  96. Syntax:
  97.  
  98.     AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /DATE ] [ /Iinitfile | /-I ]
  99.       [ /MOUSE | /-MOUSE ] [ /Q ] [ /? ] [ > filename ]
  100.  
  101. where:
  102.  
  103. "filespec" is the file specification to process.  Can include drive,  path,  and
  104. wildcards if desired.
  105.  
  106. "/P" says to view the directory in page mode.  This is  typically  the  default.
  107. The default is automatically /-P (which can't be overridden) if redirection ("AV
  108. ... > filename") is used.
  109.  
  110. "/-P" says to view the directory not in page mode.  This prevents you from being
  111. offered the fix-date option as well.  This mode is automatic if redirection ("AV
  112. ... > filename") is used.
  113.  
  114. "/Ox" and "/O-x" allow you to specify the display order for the files.  "x"  can
  115. be one of the following:
  116.  
  117.         N = file name
  118.         E = file extension
  119.         D = file date and time
  120.         S = file size of the original (non-compressed) file
  121.         C = current (compressed) size of the file
  122.         R = compression ratio
  123.         P = path and file name order
  124.         O = original order (no sorting)
  125.  
  126. If you precede the "x" with a dash ("-"), the  sort  will  be  done  in  reverse
  127. order.  Initially defaults to /OO.
  128.  
  129. "/DATE" resets the file date to that of the most recent  member.   Automatically
  130. invokes /-P.  The command "AV *.* /DATE /Q" is a quick way  to  reset  the  file
  131. date stamps for all archives in your current subdirectory.
  132.  
  133. "/Iinitfile" says to read an initialization file with the file name  "initfile".
  134. The file specification *must* contain a period.  Initfiles are described in  the
  135. BRUCEINI.DOC file.  Initially defaults to "/IAV.INI".
  136.  
  137. "/-I" (or "/INULL") says to skip loading the initialization file.
  138.  
  139.  
  140. AV.DOC                               4                         Revised: 05/28/96
  141.  
  142. "/MOUSE" says to activate the mouse if present.  This is initially the default.
  143.  
  144. "/-MOUSE" says to skip activating the mouse even if present.
  145.  
  146. "/Q" skips the display of the member names.  Automatically invokes /DATE and /-P
  147. and is typically used in cases where you want to reset all file dates (e.g.  "AV
  148. *.* /Q").
  149.  
  150. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  151.  
  152. ">filename" redirects the output to a text file.  This automatically invokes the
  153. /-P option.  This is useful for getting a complete listing of  the  contents  of
  154. your compressed files.  For example:
  155.  
  156.         AV *.* > TEMP.TXT
  157.  
  158.  
  159. Return codes:
  160.  
  161. AV returns the following ERRORLEVEL codes:
  162.  
  163.         0 = no problems
  164.       254 = no valid archives were found
  165.       255 = syntax problems, file not found, or /? requested
  166.  
  167.  
  168. Author:
  169.  
  170. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  171. and redistribution provided relevant documentation is kept with the program,  no
  172. changes are made to the program or documentation, and it  is  not  bundled  with
  173. commercial programs or charged for separately.  People who need to bundle it  in
  174. for-sale packages must pay a $50 registration fee to  "Wayne  Software"  at  the
  175. following address.
  176.  
  177. Additional information about this and other Wayne Software programs can be found
  178. in the file BRUCEymm.DOC which should be included  in  the  original  ZIP  file.
  179. ("ymm" is replaced by the last digit of the year and the two digit month of  the
  180. release.  BRUCE512.DOC came out in December 1995.  This same  naming  convention
  181. is used in naming the ZIP file that this program was included in.) Comments  and
  182. suggestions can also be sent to:
  183.  
  184.  
  185.                 Bruce Guthrie
  186.                 Wayne Software
  187.                 113 Sheffield St.
  188.                 Silver Spring, MD 20910
  189.  
  190.                 fax: (301) 588-8986
  191.                 e-mail: bguthrie@nmaa.org
  192.                 http://hjs.geol.uib.no/guthrie/
  193.  
  194. See BRUCEymm.DOC file for additional contact information.
  195.  
  196. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  197.  
  198. 
  199.